jEdit
4. Debugging Interface for Sentaurus Structure Editor

4.1 Debugging Sentaurus Structure Editor with jEdit
4.2 Using the Debugging Interface
4.3 Shortcut Key Assignments
4.4 Starting Sentaurus Structure Editor Debugging Mode from Sentaurus Workbench

Objectives

• To demonstrate how to use the debugging interface for Sentaurus Structure Editor.

4.1 Debugging Sentaurus Structure Editor with jEdit

It is sometimes useful to execute Sentaurus Structure Editor commands interactively step-by-step to see the result of each command and to understand where an error may occur. For that purpose, the Sentaurus Structure Editor debugging mode of jEdit may be used. If you have the Sentaurus jEdit customizations installed (see Section 1. Setting Up Sentaurus Customizations), the debugging mode is already available.

To start Sentaurus Structure Editor in jEdit debugging mode, use:

sde -editor filename

This command opens a Sentaurus Structure Editor window as well as the Sentaurus Structure Editor command file in jEdit, ready for debugging.

Alternatively, if a Sentaurus Structure Editor window is already open, select Edit > Text Editor. The jEdit window opens in debugging mode.

To start the debugging mode from Sentaurus Workbench, see Section 4.4 Starting Sentaurus Structure Editor Debugging Mode from Sentaurus Workbench.

4.2 Using the Debugging Interface

The debugging interface defines three jEdit macros to use with Sentaurus Structure Editor:

• send-selected: Sends the current jEdit selection to Sentaurus Structure Editor.
• send-current-block: Localizes the command block with matching parenthesis pairs at the current cursor position, selects it, and sends it to Sentaurus Structure Editor.
• send-next-command: Tries to find the next command block, relative to the current cursor position or selection, selects it, and sends it to Sentaurus Structure Editor.

4.3 Shortcut Key Assignments

To make debugging more convenient, shortcuts can be assigned to these macros. From the jEdit menu bar, select Utilities > Global Options, and assign the shortcut keys to the corresponding debugging functions (see Figure 1).

Figure 1. Defining shortcuts to access Sentaurus Structure Editor debugging macros. (Click image for full-size view.)

With the shortcut assignments shown in Figure 1, you can smoothly move through commands by pressing the F8 key subsequently, investigate the result of a selected expression (for example, a variable) by pressing the F6 key, or evaluate a complex nested command block step-by-step by placing the cursor inside the innermost parenthesis and pressing the F7 key subsequently.

4.4 Starting Sentaurus Structure Editor Debugging Mode from Sentaurus Workbench

You can start the Sentaurus Structure Editor debugging mode from within Sentaurus Workbench. For this, a new viewer must be defined by adding the following lines to the user tooldb_<username> file in the $STDB directory:

global WB_viewer
global WB_binaries
set WB_viewer(sde_editor,files) "*@node@_dvs.cmd"
set WB_viewer(sde_editor,label) "sde and editor"
set WB_viewer(sde_editor,nbfiles) 1
set WB_viewer(sde_editor,cmd_line) "-editor @files@"
set WB_viewer(sde_editor,exec_dir) @pwd@
set WB_binaries(viewer,sde_editor) sde
lappend WB_viewer(all) sde_editor

After restarting Sentaurus Workbench, you can click the node (not the Sentaurus Structure Editor tool) that you want to debug and open the Node Explorer.

In the Node Explorer, select the Sentaurus Structure Editor command file pp*_dvs.cmd, select sde in the Viewer field, and click Launch. This opens a Sentaurus Structure Editor window as well as the Sentaurus Structure Editor command file in jEdit, ready for debugging.